home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / vfam114.zip / VFAM.DOC < prev    next >
Text File  |  1991-05-10  |  52KB  |  1,176 lines
  1.  
  2.      ▄ ▄▄    ▄▄  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  3.      █ ██    ██                          █
  4.      █ ██    ██ ▄▄▄▄▄ ▄▄▄▄   ▄▄▄▄  ▄▄▄   █  VersaFAM File Area Manager
  5.      █ ██    ██ █▀▀▀▀ █▀▀██ █▀▀▀▀ █▀▀██  █  for Opus, Maximus and other
  6.      █ ██▄  ▄██ █▄▄   █  ██ █▄▄▄  █▄▄██  █  Bulletin Board systems
  7.      █  ██  ██  █▀▀   █▀██▀  ▀███ █▀▀██  █
  8.      █   ████   █▄▄▄▄ █  █▄ ▄▄███ █  ██  █  Written by:  Bill Auclair
  9.      █    ▀▀    ▀▀▀▀▀ ▀  ▀▀ ▀▀▀▀  ▀  ▀▀  █  FidoNet node # 1:141/545
  10.      █ ▄▄▄▄▄▄▄▄▄  ▄▄▄▄▄▄▄  ▄▄▄      ▄▄▄  █  Copyright 1991 by XanSoft
  11.      █ ███▀▀▀▀▀▀ ███▀▀▀███ ████▄  ▄████  █  ALL RIGHTS RESERVED
  12.      █ ███       ███   ███ ███▀█▄▄█▀███  █
  13.      █ ███▄▄▄    ███▄▄▄███ ███  ██  ███  █  Disk/EMS swapping routines
  14.      █ ███▀▀▀    ███▀▀▀███ ███  ▀▀  ███  █  (C) 1988 TurboPower Software
  15.      █ ███       ███   ███ ███      ███  █
  16.      █ ███       ███   ███ ███      ███  █  ****************************
  17.      █ ███       ███   ███ ███      ███  █    V e r s i o n   1 . 1 4
  18.      █                                   █  ****************************
  19.      ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  20.  
  21.  
  22.  
  23.      -------------------------------------------------------------------
  24.      DOCUMENT OUTLINE AND TABLE OF CONTENTS
  25.      -------------------------------------------------------------------
  26.      I.    General Description ...................................   3
  27.            a.  What is VersaFAM? .................................   3
  28.  
  29.      II.   Installing and Configuring VersaFAM ...................   4
  30.            a.  The VFAM environmental variable ...................   5
  31.            b.  The VFAM.DAT configuration file ...................   5
  32.                i.  configuration file verb definitions ...........   5
  33.  
  34.      III.  Using VersaFAM ........................................   9
  35.            a.  HELP screens ......................................   9
  36.            b.  1st-level menu commands ...........................   9
  37.            c.  2nd-level menu commands ...........................  11
  38.            d.  3rd-level menu commands ...........................  15
  39.            e.  The OEC text editor ...............................  16
  40.            f.  Using text templates ..............................  20
  41.            g.  Running VersaFAM remotely .........................  21
  42.  
  43.      IV.   VersaFAM Utilities ....................................  22
  44.            a.  FILEX file update utility .........................  22
  45.            b.  CBFSORT list file sort utility ....................  22
  46.            c.  OEC2VFAM list file conversion utility .............  22
  47.            d.  VFADD path import utility .........................  22
  48.  
  49.  
  50.  
  51.      VersaFAM v1.14                     - 2 -
  52.  
  53.      -------------------------------------------------------------------
  54.      DISCLAIMER
  55.      -------------------------------------------------------------------
  56.      This software is provided "as is", without warranty of any kind,
  57.      either expressed or implied, including but not limited to implied
  58.      warranties of merchantability and fitness for a particular purpose.
  59.      You are advised to use this program at your own risk.  XanSoft
  60.      Development, Inc. and/or Bill Auclair shall not be held liable for
  61.      any damages, including lost data, lost profits, lost monies or
  62.      other special, incidental or consequential damages arising from
  63.      the use or inability to use VersaFAM.  The VersaFAM program package
  64.      may be freely distributed, providing the contents of the archive
  65.      are kept intact, and the executable files are not modified in
  66.      any way.
  67.  
  68.  
  69.  
  70.  
  71.      FILES INCLUDED IN THE VERSAFAM PACKAGE:
  72.  
  73.                 VFAM.DOC       The documentation you're reading
  74.                 FILEX.DOC      FILEX program documentation
  75.                 REGISTER.DOC   VFAM registration information
  76.                 VFAM.EXE       The VersaFAM executable file
  77.                 VFAM.OVR       Overlay file for VFAM.EXE
  78.                 FILEX.EXE      The FILEX file update utility
  79.                 CBFSORT.EXE    The CBFSORT listfile sort utility
  80.                 OEC2VFAM.EXE   Converts OEC files to VersaFAM format
  81.                 VFADD.EXE      The VFADD path import utility
  82.                 VFAM.DAT       Sample VersaFAM configuration file
  83.                 FILEX.DAT      Sample FILEX configuration file
  84.                 *.HDR          Sample header files
  85.                 *.TPL          Sample text template files
  86.                 GETVFAM.BAT    A sample DOORWAY<tm> batch file
  87.                 GETVFAM.MNU    A sample DOORWAY<tm> password file
  88.  
  89.  
  90.      NOTE:  Beginning with version 1.14, all executable files within the
  91.             VersaFAM archive have been compacted with the LZEXE compression
  92.             utility.  This results in as much as 60% reduction in file sizes,
  93.             without any measurable degradation in performance.
  94.             
  95.  
  96.  
  97.      VersaFAM v1.14                    - 3 -
  98.  
  99.      -------------------------------------------------------------------
  100.      GENERAL DESCRIPTION: What Is VersaFAM?
  101.      -------------------------------------------------------------------
  102.      VersaFAM is a file area manager for Opus 1.03x, 1.10x and other
  103.      compatible bulletin board systems using the same list file format.
  104.      VersaFAM was designed to optimize the efficiency of file management
  105.      through the use of scrolling windows, intuitive menus and virtual
  106.      screen data input, allowing sysops to manage file areas through the
  107.      use of *one* program, rather than several.  VersaFAM will support
  108.      up to 256 file areas, with a maximum of 1024 files in each area,
  109.      for a total of 262,144 possible files.  Built-in help screens
  110.      listing available keystroke commands and other useful information
  111.      are available by pressing the function keys from any part of
  112.      VersaFAM *except* the text editor.  VersaFAM supports list files of up
  113.      to 1024 lines. Each line can contain up to 127 characters, including
  114.      OEC control codes.
  115.  
  116.  
  117.      OVERLAYS AND MEMORY-SWAPPING
  118.      ----------------------------
  119.      VersaFAM makes use of special memory-swapping routines developed by
  120.      Kim Kokkonen of TurboPower Software.  When invoking the VersaFAM
  121.      DOS shell or any of the external program "hooks", most of the
  122.      VersaFAM program is intelligently swapped out to expanded memory or
  123.      hard disk, leaving more memory to use while within the shell or program.
  124.      VersaFAM versions 1.14 and up are now overlaid in combination with "smart"
  125.      dynamic memory allocation, reducing RAM overhead needed to a minimum of 
  126.      approximately 165K.  If EMS memory is available, the overlay manager uses
  127.      it instead of swapping overlays from disk.
  128.  
  129.  
  130.      EMS MEMORY AVAILABILITY
  131.      -----------------------
  132.      While VersaFAM will work perfectly well without expanded memory, it
  133.      is highly recommended that approximately 130-150K of EMS memory be
  134.      free for use by the program.  VersaFAM will operate much faster if
  135.      it is able to swap to EMS, rather than to a slower hard disk drive.
  136.      A compromise might be to specify a RAM disk as the swap directory.
  137.  
  138.  
  139.      BASIC FUNCTIONS
  140.      ---------------
  141.      Used as a basic file area manager, VersaFAM can be used to HURL, DUPE,
  142.      MOVE, ERASE or otherwise manipulate files and file descriptions from one
  143.      subdirectory to another, automatically updating list files for the
  144.      subdirectories involved. An integrated LOCATE function makes searching for
  145.      specific files and/or file descriptions quick and easy. An integrated
  146.      MARK/UNMARK function can be used in conjunction with HURL, DUPE and ERASE
  147.      to facilitate mass processing of files.
  148.  
  149.  
  150.      ARCHIVE UTILITY SUPPORT
  151.      -----------------------
  152.      Full archive utility support is now "hard-coded" into VersaFAM.  Files
  153.      archived in LZH (both old and new), ZIP, ARC, ARJ and PAK formats can be
  154.      listed, extracted, edited and even updated with a few keystrokes.
  155.      Regular files can be archived just as easily.  Text files, archived or
  156.      unarchived, can be viewed with a keystroke, using your favorite editor.
  157.  
  158.  
  159.      VersaFAM v1.14                    - 4 -
  160.  
  161.      OEC TEXT EDITOR
  162.      ---------------
  163.      VersaFAM supports a subset of the Opus Embedded Codes (used to
  164.      change text and background colors) in its text editor.
  165.      With virtual screen input, users can add, change or delete file names,
  166.      file descriptions or descriptive text lines as desired. Entire
  167.      lines can be inserted, moved, copied or deleted as needed.  Ten special
  168.      graphics character sets can be accessed through function keys.  OEC text
  169.      encode/decode can be turned off by using the NoOEC configuration file
  170.      verb, or by pressing CTRL/O at the 2nd-level menu.  A bi-level text
  171.      search capability is also fully implemented.
  172.  
  173.  
  174.      EXTERNAL FUNCTIONS
  175.      ------------------
  176.      External programs may be invoked within VersaFAM, which will swap itself
  177.      to EMS or hard disk and pass control to the called program. When the
  178.      external program finishes its work, it will terminate and pass control
  179.      back to VersaFAM.  Some external routines have been "hard-coded"
  180.      into VersaFAM-- the INDEX, PROBE, PACK, UNPACK and TEXT commands are
  181.      examples of this.  Up to ten additional external program calls may be
  182.      user-specified in conjunction with the EXTFUNCxx verbs in the VFAM.DAT
  183.      configuration file.
  184.  
  185.  
  186.      TEXT TEMPLATES
  187.      --------------
  188.      Up to 10 text "template" files may be specified for easy insertion
  189.      anywhere within the body of a list file, saving users the effort of
  190.      having to create often-used text and graphics from scratch.
  191.  
  192.  
  193.      REMOTE OPERATION
  194.      ----------------
  195.      VersaFAM can be run remotely, in conjunction with Marshall Dudley's
  196.      DOORWAY<tm> or similar I/O redirection utilities.  All local keyboard
  197.      operations, including extended keycode ALT, CTRL, SHIFT and function key
  198.      combinations are fully supported in remote mode.
  199.  
  200.  
  201.      INFORMATION FILE
  202.      ----------------
  203.      The automatic addition of a user-specified "information file" to
  204.      archive libraries has been implemented in VersaFAM v1.08 and later.
  205.  
  206.  
  207.  
  208.  
  209.      -------------------------------------------------------------------
  210.      INSTALLING AND CONFIGURING VERSAFAM
  211.      -------------------------------------------------------------------
  212.      To use VersaFAM, first copy the VFAM.EXE executable file, the VFAM.OVR
  213.      overlay file and the VFAM.DAT configuration file to a suitable 
  214.      subdirectory.  All three files should be in the same subdirectory,
  215.      preferably one defined in the DOS path statement.
  216.  
  217.  
  218.  
  219.      VersaFAM v1.14                   - 5 -
  220.  
  221.      -------------------------------------------------------------------
  222.      THE VFAM ENVIRONMENTAL VARIABLE
  223.      -------------------------------------------------------------------
  224.      VersaFAM depends upon the use of a DOS environmental variable to
  225.      maximize the ease of navigation through different drives and
  226.      directories on your system.  Add the following line to your
  227.      AUTOEXEC.BAT file, then reboot your system:
  228.  
  229.  
  230.                          set VFAM=d:\path
  231.  
  232.  
  233.      where d:\path is the drive and subdirectory in which the VersaFAM
  234.      configuration file VFAM.DAT is located.  The VersaFAM executable
  235.      file VFAM.EXE may be placed in a subdirectory within your DOS
  236.      path, so that it is available from any subdirectory.
  237.  
  238.  
  239.  
  240.      -------------------------------------------------------------------
  241.      THE VFAM.DAT CONFIGURATION FILE
  242.      -------------------------------------------------------------------
  243.      VFAM.DAT is the name of the ASCII text file that tells VersaFAM where
  244.      the list file subdirectories are located, and also which program
  245.      options have been chosen.  VersaFAM cannot run without VFAM.DAT.
  246.  
  247.      VFAM.DAT should be edited to reflect your system's parameters.
  248.      A simple text editor can be used for this purpose.  Do not use fancy
  249.      word processing programs to edit VFAM.DAT, as the extra codes they
  250.      add may confuse VersaFAM.
  251.  
  252.      If you run an Opus<tm> system, the VFADD path import utility may be
  253.      used to quickly append path information from Opus SYSTEM??.BBS or
  254.      SYSTEM??.DAT files to VFAM.DAT.  Invoke VFADD from DOS with no
  255.      command-line parameters for further information.
  256.  
  257.  
  258.      Configuration file verbs, listed in alphabetical order:
  259.  
  260.  
  261.      BACKUP-   The name of the file to copy list file contents to when
  262.                using the BACKUP command in the 1st-level menu.  No drive/
  263.                path information is required.
  264.  
  265.  
  266.      BIOS-     If uncommented (no semicolon before it), specifies use of
  267.                slower BIOS screen writes, rather than the default direct
  268.                writes.  You may need to use this option if you're having
  269.                trouble with screens "bleeding" from one partition to
  270.                another in a multitasking setup, or if you wish to run
  271.                VersaFAM as a remotely-controlled "door".
  272.  
  273.      DOS
  274.      PASSWORD- The password authorizing remote access to DOS using the OS
  275.                function in 1st, 2nd or 3rd-level menus.
  276.  
  277.  
  278.  
  279.      VersaFAM v1.14                    - 6 -
  280.  
  281.      EDITOR-   Specifies the utility to be used to display or edit files.
  282.                The utility must be one in which the name of the target
  283.                file can be specified on the command line, as in the
  284.                example LIST <filename.ext>.  If an editor is not
  285.                specified, LIST is used by default.
  286.  
  287.  
  288.      EXTFUNCx- Full drive, path and filename information for external programs
  289.                to be invoked from within VersaFAM by pressing ALT-F1 through
  290.                ALT-F10 (depending upon which program is desired) at the 2nd-
  291.                level menu.  A maximum of ten external programs may be specified.
  292.  
  293.  
  294.      INFOFILE- The full drive and path information for the file to be
  295.                optionally added as an "information file" to archives.
  296.  
  297.  
  298.      LISTFILE- The name of the file containing file description info,
  299.                usually FILES.BBS for Opus systems.  No drive/path
  300.                information is required.
  301.  
  302.  
  303.      LISTHDR-  The full drive, path and filename information describing
  304.                the file you wish to use as a "header" file for each file
  305.                area.  When creating a new file area from scratch, or if
  306.                the list file for an area is not found, this file will
  307.                automatically be appended to the beginning of the list
  308.                file, if specified.  The list file header can optionally be
  309.                inserted anywhere within the list file by positioning the
  310.                cursor to the desired location and pressing ALT-H at the
  311.                2nd-level menu.
  312.  
  313.  
  314.      MONITOR
  315.      DRIVE-    The drive whose free space is to be monitored on the 1st-level
  316.                menu.  A trailing backslash ("\") is not required.
  317.  
  318.  
  319.      NOEMS-    Tells VFAM not to use expanded memory, even if it is available.
  320.  
  321.  
  322.      NOOEC-    Tells VFAM to "turn off" encode/decode of OEC codes.
  323.  
  324.  
  325.      NOLOGO-   Disables the VFAM logo at the 1st menu level.
  326.  
  327.  
  328.      ORPHAN
  329.      DESC-     Specifies the descriptive string to be appended to all
  330.                PROBEd files in the list file, using the externally-called
  331.                FILEX file update utility.
  332.  
  333.                NOTE: FILEX OEC color codes can be used in conjunction
  334.                with this feature to give adopted file descriptions a
  335.                distinctive color, blink, etc.  See the FILEX
  336.                documentation for more details.
  337.  
  338.  
  339.  
  340.      VersaFAM v1.14                    - 7 -
  341.  
  342.      PACKER-   Specifies the utility to be used to archive files.  The
  343.                descriptors below are valid:
  344.  
  345.                                  ARCA
  346.                                  ARJ
  347.                                  PAK
  348.                                  PKZIP
  349.                                  LHARC
  350.                                  LHA
  351.  
  352.                If PACKER is not specified, "ARCA" is used by default.  The
  353.                specified PACKER must be available on your DOS path.
  354.  
  355.  
  356.      REPACK
  357.      EDITFILE- Enables updating of archive files with "new" version after an
  358.                editing operation has been performed using the VIEW and TEXT
  359.                commands (This assumes a text editor has been associated with
  360.                the EDITOR configuration file verb).  NOTE:  This option adds
  361.                considerable time to the editing process, and should only be
  362.                used when absolutely necessary. Due to limitations of the ARCA
  363.                program, updating of ARCed files is not supported.
  364.  
  365.  
  366.      SOUND-    Leave this line commented if you don't want VersaFAM to
  367.                "beep" when entering text edit mode, when missing
  368.                files are encountered, or when long file lines are found.
  369.  
  370.  
  371.      STATUS
  372.      LOG-      Full path and filename of the file to be used to log VersaFAM
  373.                operations.  If the file does not exist, it will be created; if
  374.                it already exists, it will be appended.
  375.  
  376.  
  377.      SWAPDIR-  The full drive and path information used for storage of the
  378.                hidden swap file (VFAM.$$$) generated whenever VersaFAM is
  379.                swapped to hard disk.  If not specified, defaults to the
  380.                string specified in the VFAM environmental variable.  Not
  381.                used if sufficient EMS memory is available.
  382.  
  383.  
  384.      SYSDIR-   The full drive and path information for each of the file
  385.                areas you wish to use with VersaFAM. A trailing backslash
  386.                ("\") is not required.
  387.  
  388.  
  389.      TEMPLATEx-  The full drive, path and filename information for files
  390.                  to be used as text templates.  Templates can be inserted
  391.                  anywhere within a list file by pressing CTRL-F1 through
  392.                  CTRL-F10 (depending upon the template to be used) at the
  393.                  2nd-level menu.  A maximum of ten template files may be
  394.                  specified.
  395.  
  396.  
  397.  
  398.      VersaFAM v1.14                    - 8 -
  399.  
  400.      TEXTFLAG- The identity of the character to use when "padding"
  401.                the first column of a non-file text line in text
  402.                edit mode. This padding has to be done so Opus (and
  403.                other BBS software) won't try to interpret the text
  404.                as a filename. The default is SPACE (' ').
  405.  
  406.  
  407.      UNARCDIR- The full drive and path information for the directory you
  408.                wish files to be UNPACKed to.  This subdirectory is also used
  409.                by VersaFAM as a temporary storage area for VIEWed files.
  410.                A trailing backslash ("\") is not required.
  411.  
  412.  
  413.      ZAPDIR-   The full drive and path information for the directory you
  414.                wish to use as a ZAP directory (a directory where old/obsolete
  415.                files are stored prior to archiving/deleting). The ZAP
  416.                directory is automatically appended as the last entry in the
  417.                list of ACTIVE subdirectories, facilitating single-keystroke
  418.                access through use of the END key.  A trailing backslash ("\")
  419.                is not required.
  420.  
  421.                NOTE:  This was formerly the SALEDIR verb in older VFAM
  422.                versions.  If using an older config file, you will have to
  423.                change "SALEDIR" to "ZAPDIR" for this to work.
  424.  
  425.  
  426.  
  427.  
  428.      VersaFAM v1.14                    - 9 -
  429.  
  430.  
  431.      -------------------------------------------------------------------
  432.      USING VERSAFAM
  433.      -------------------------------------------------------------------
  434.      VersaFAM is invoked from the DOS command line by typing VFAM and
  435.      pressing the <ENTER> key.  This will bring up the 1st-level menu.
  436.      If the VFAM.DAT file has been configured correctly, you should see
  437.      a listing of ACTIVE directories, a ZAP directory, and a list
  438.      file name.  Use the cursor arrow keys, the Pg keys, the Home or End
  439.      keys to change the location of the highlight bar.  The position of
  440.      the highlight bar determines which file area is to be displayed in
  441.      the 2nd level menu.
  442.  
  443.  
  444.  
  445.      -------------------------------------------------------------------
  446.      THE HELP SCREENS
  447.      -------------------------------------------------------------------
  448.      Detailed help screens are available to the novice VersaFAM user by
  449.      pressing F1, F2 or F3 anywhere within the program *except* the text
  450.      editor.
  451.  
  452.      The F1 help screen lists undocumented keystroke commands not displayed
  453.      on menu screens.
  454.  
  455.      The F2 help screen lists current external program assignments (if any),
  456.      as determined by the EXTFUNCx verbs in VFAM.DAT.
  457.  
  458.      The F3 help screen lists current text template file assignments (if any),
  459.      as determined by the TEMPLATEx verbs in VFAM.DAT.
  460.  
  461.  
  462.  
  463.      -------------------------------------------------------------------
  464.      1ST-LEVEL MENU COMMANDS
  465.      -------------------------------------------------------------------
  466.      Available 1st-level menu commands are:
  467.  
  468.  
  469.  
  470.      ZAP-     Automatically erases all files referenced in the list file
  471.               for the ZAP directory.  A quick, easy way to clean out
  472.               obsolete files. The ZAP directory list file is updated.
  473.  
  474.  
  475.      LOCATE-  Allows searching/matching of file names and descriptions
  476.               to a user-specified search string.  If invoked at the 1st
  477.               menu level, LOCATE will automatically search the list file
  478.               for each file area, *starting* from the current cursor
  479.               location. If a match is found, the 2nd menu level is
  480.               invoked for the specified subdirectory, and the cursor is
  481.               moved to the file line containing the matching string.
  482.               If a match is not found, a "no match found!" message is
  483.               displayed on the 1st level menu screen.
  484.  
  485.  
  486.      VersaFAM v1.14                    - 10 -
  487.  
  488.  
  489.      INDEX-   Swaps VersaFAM out of memory and activates the external
  490.               CBFSORT list file sorting program.  All groupings and
  491.               subgroupings of files within the list file at the cursor
  492.               position are alphanumerically sorted.  The position of
  493.               text and descriptive lines is not changed.
  494.  
  495.  
  496.      PROBE-   Swaps VersaFAM out of memory and activates the external
  497.               FILEX list file update program.  FILEX is passed a
  498.               command line by VersaFAM that instructs it to probe the
  499.               currently active directory, looking for any files not
  500.               displayed in the list file.  If such files are found,
  501.               their names are automatically appended to the list file,
  502.               along with a user-specified description determined by
  503.               the OrphanDesc verb in the VFAM.DAT configuration file.
  504.  
  505.               NOTE: Newer versions of VersaFAM are incompatible with FILEX
  506.               versions older than 1.07a-- if you are using FILEX 1.06 or
  507.               older, please upgrade to the newer version included in this
  508.               archive.
  509.  
  510.      OS-      Shells to DOS.  If operating remotely, users will first be
  511.               prompted for a password.  Incorrect passwords will force a
  512.               return to whatever menu level OS was invoked from.  Type 'EXIT'
  513.               and then press <ENTER> to return to VersaFAM.  VersaFAM uses
  514.               memory-swapping routines written by Kim Kokkonen of TurboPower
  515.               Software.  These routines maximize the amount of usable RAM in
  516.               the shell by swapping most of the parent program to disk or to
  517.               EMS memory.
  518.  
  519.  
  520.      BACKUP-  Backs up the list file in the currently ACTIVE directory by
  521.               copying it to a specified filename in the same directory.
  522.  
  523.  
  524.      QUIT-    Terminates the VersaFAM program.  The ESC key can no longer
  525.               be used for this purpose at the 1st menu level.
  526.  
  527.  
  528.      Cursor
  529.      keys-    Use the cursor arrow keys to move through the listed
  530.               subdirectories one at a time.  Use the PgUp/PgDn keys
  531.               to move through the listed subdirectories one screenful
  532.               at a time.  Use the HOME and END keys to move to the top
  533.               and bottom of the subdirectory list, respectively.
  534.  
  535.  
  536.      ESC key- Press <ESC> to back up to a previous menu level, or quit
  537.               the VersaFAM program.
  538.  
  539.  
  540.  
  541.  
  542.      VersaFAM v1.14                    - 11 -
  543.  
  544.      -------------------------------------------------------------------
  545.      2ND-LEVEL MENU COMMANDS
  546.      -------------------------------------------------------------------
  547.      After a file area has been selected in the 1st-level menu, the
  548.      2nd-level menu is brought up.  The list file name, ZAP
  549.      directory, currently ACTIVE directory and UNARC directory
  550.      are displayed. If the cursor is moved to a valid file description
  551.      line using cursor keys, the FILE DATE, FILE SIZE and FILE NAME
  552.      windows will list information for the file at the cursor location.
  553.  
  554.      If the file line does not contain a valid file description (e.g.,
  555.      a descriptive text line), the phrase 'NON-FILE' will appear in the
  556.      FILE SIZE window; the FILE DATE and FILE NAME windows will blank.
  557.  
  558.      If a valid file at the cursor location cannot be found in DOS, the
  559.      word 'MISSING' will appear in the FILE SIZE window; the FILE DATE
  560.      and FILE NAME windows will blank; the file description will be
  561.      appended with OEC codes, causing it to blink off and on.  The only
  562.      2nd-level command valid for MISSING files is DELete.
  563.  
  564.      If a file line is of a length that would cause it to "wrap" to the next
  565.      line when displayed in Opus and other compatible BBS programs, VFAM will
  566.      flag this condition by highlighting the line when the cursor is moved
  567.      over it.  Long lines will be displayed in light blue on a gray background,
  568.      rather than the standard black on gray background.  If the SOUND verb
  569.      is active in VFAM.DAT, an audible tone will sound when the cursor is
  570.      moved over long lines.
  571.  
  572.  
  573.      Available 2nd-level menu commands are:
  574.  
  575.  
  576.      ERASE-   Deletes the file at the current cursor position in the current
  577.               ACTIVE directory.  List file is updated.
  578.  
  579.  
  580.      INDEX-   Swaps VersaFAM out of memory and activates the external
  581.               CBFSORT list file sorting program.  All groupings and
  582.               subgroupings of files within the currently active
  583.               list file are alphanumerically sorted.  The position of
  584.               text and descriptive lines is not changed.
  585.  
  586.  
  587.      HURL-    Transfers a file from the current ACTIVE directory to
  588.               any other valid directory specified in the VFAM.DAT
  589.               configuration file.  List files in both directories are
  590.               updated.  Hurling across drives is supported.  When the
  591.               split-screen HURL display appears, use the cursor arrow keys,
  592.               HOME key or END key to automatically scroll through a
  593.               list of input selections determined by the SYSDIR verbs in
  594.               VFAM.DAT.  When the desired directory name is highlighted, press 
  595.               the <ENTER> key.
  596.  
  597.  
  598.      WRITE-   Enables the VersaFAM OEC text editor.  See the section titled
  599.               "THE OEC TEXT EDITOR" for more information.
  600.  
  601.  
  602.      VersaFAM v1.14                    - 12 -
  603.  
  604.  
  605.      MOVE-    Allows physical relocation of filenames and descriptions
  606.               within a list file.  When the letter "M" is pressed, the
  607.               entry under the current cursor location is "picked up",
  608.               highlighted in blinking reverse video.  The cursor arrow
  609.               keys, Pg keys or Home/End keys can then be used to
  610.               transport the highlighted file line to another location
  611.               within the same list file. Pressing ENTER "puts down" the
  612.               file line once a suitable location is found.
  613.  
  614.  
  615.      LOCATE-  Allows searching searching/matching of filenames and
  616.               descriptions to a user-specified search string.  If
  617.               invoked from the 2nd menu level, LOCATE will automatically
  618.               search the current list file for a string to match the
  619.               specified search string, *starting* at the current cursor
  620.               location.  If a 1st-level LOCATE has previously been done,
  621.               the search string for that operation is retained for
  622.               default use, or can be changed as required.  If a matching
  623.               string is not found, a "no match found!" message is
  624.               displayed on the 2nd-level menu screen.
  625.  
  626.  
  627.      RENAME-  Allows renaming of a file or file extension at the DOS
  628.               level.  The list file is also updated.  Only the
  629.               overstrike cursor can be used in this mode.
  630.  
  631.  
  632.      DUPE-    Copies the selected file to any valid subdirectory. The
  633.               list file is not updated.
  634.  
  635.  
  636.      VIEW-    Allows the contents of ARCed, PAKed, ARJed, ZIPed or LHARCed
  637.               archive files to be viewed in a row-and-column format
  638.               similar to that provided by the utilities themselves.
  639.               Archive identification is automatic, regardless of the
  640.               file extensions used.  VIEW will not work on non-archived
  641.               files, or files using a compression format different from
  642.               those described above.
  643.  
  644.  
  645.      TEXT-    Allows the contents of a listed text file to be displayed
  646.               in the user's favorite editor or file list utility,
  647.               dependent upon the information supplied after the 'Editor'
  648.               verb in the VFAM.DAT configuration file.
  649.  
  650.  
  651.      OS-      Shells to DOS.  If operating remotely, users will first be
  652.               prompted for a password.  Incorrect passwords will force a
  653.               return to whatever menu level OS was invoked from.  Type 'EXIT'
  654.               and then press <ENTER> to return to VersaFAM.  VersaFAM uses
  655.               memory-swapping routines written by Kim Kokkonen of TurboPower
  656.               Software.  These routines maximize the amount of usable RAM in
  657.               the shell by swapping most of the parent program to disk or to
  658.               EMS memory.
  659.  
  660.  
  661.  
  662.      VersaFAM v1.14                    - 13 -
  663.  
  664.  
  665.      PACK-    Swaps VersaFAM out of memory, and activates an external
  666.               compression utility specified by the 'Packer' verb in the
  667.               VFAM.DAT configuration file.  The file at the current
  668.               cursor position is archived, and given a file extension
  669.               reflecting the utility used.
  670.  
  671.  
  672.      UNPACK-  Swaps VersaFAM out of memory, and activates an external
  673.               decompression utility, the identity of which is determined
  674.               by the archive type at the current cursor position.  The
  675.               archive file at the cursor position is de-archived to the
  676.               directory specified after the 'UnarcDir' verb in the
  677.               VFAM.DAT configuration file.
  678.  
  679.  
  680.      QUIT-    Quits the VersaFAM program.
  681.  
  682.  
  683.      ESC key- Press this key to back up a menu level.
  684.  
  685.  
  686.      INS key- Press this key to insert a blank line into a list file.
  687.  
  688.  
  689.      DEL key- Press this key to delete the list file line at the
  690.               current cursor location, whether it contains a valid
  691.               filename or not.  Does not erase files.
  692.  
  693.  
  694.      ALT/A-   Used to automatically add a user-specified "information
  695.               file" to the archive at the current cursor position.
  696.               The identity of the info file is determined by the
  697.               'InfoFile' verb in the VFAM.DAT configuration file.
  698.  
  699.  
  700.      ALT/C-   Copies a text line at the cursor position, displaying it
  701.               immediately above the original text line.
  702.  
  703.  
  704.      ALT/H-   Adds a header file (specified by the ListHdr verb in VFAM.DAT)
  705.               at the current cursor location.
  706.  
  707.  
  708.      ALT/L-   Loads an alternate list file for viewing/editing.
  709.  
  710.  
  711.      ALT/M-   MARKS all files in the file list for processing.
  712.  
  713.  
  714.      ALT/U-   un-MARKS all files in the file list.
  715.  
  716.  
  717.      F9-      MARKS/un-MARKS the file at the current cursor location.
  718.  
  719.  
  720.  
  721.      VersaFAM v1.14                    - 14 -
  722.  
  723.  
  724.      ALT/F1
  725.       thru
  726.      ALT/F10- Invokes external programs, as defined by ExtFunc verbs in
  727.               VFAM.DAT.
  728.  
  729.      
  730.      CTRL/A-  Toggles the default PACKER from among a list of 7 selections.
  731.               PACKER returns to default when returning to the 1st-level menu.
  732.  
  733.  
  734.      CTRL/C-  Capitalizes file descriptions at the cursor location.
  735.  
  736.  
  737.      CTRL/L-  Lowercases file descriptions at the cursor location.
  738.  
  739.  
  740.      CTRL/O-  Toggles OEC encode/decode ON or OFF.
  741.  
  742.  
  743.      CTRL/U-  Uppercases file descriptions at the cursor location.
  744.  
  745.  
  746.      CTRL/F1
  747.       thru
  748.      CTRL/F10- Inserts a text template (specified by the Template verbs in
  749.                VFAM.DAT) at the current cursor position.
  750.  
  751.  
  752.  
  753.      VersaFAM v1.14                    - 15 -
  754.  
  755.  
  756.      -------------------------------------------------------------------
  757.      3RD-LEVEL MENU COMMANDS
  758.      -------------------------------------------------------------------
  759.      The 3rd-level menu displays contents of archived files for viewing
  760.      or further processing.  The 3rd-level menu is accessed by selecting
  761.      the VIEW option at the 2nd menu level.
  762.  
  763.  
  764.      The following commands are available in the 3rd-level menu:
  765.  
  766.  
  767.      OS-      Shells to DOS.  Type 'EXIT' and then press <ENTER> to
  768.               return to VersaFAM.
  769.  
  770.  
  771.      TEXT-    Allows viewing/editing of text files within an archived
  772.               file.  If used in conjunction with the 'RepackEditFile'
  773.               verb in VFAM.DAT, the archive file may be updated with
  774.               the revised contents of the text file. The editor
  775.               specified must exist within the DOS path.
  776.  
  777.  
  778.      UNPACK-  Swaps VersaFAM out of memory and activates an external
  779.               decompression utility.  The identity of the utility is
  780.               dependent upon the archive type.  When UNPACK is chosen
  781.               from the 3rd-level menu, it allows de-archiving of
  782.               individual files to the directory specified by the
  783.               'UnarcDir' verb in the VFAM.DAT configuration file.
  784.               The utilities ARCE, PAK, ZIP, LHA or LHARC must be available
  785.               in the DOS path for this function to work properly.
  786.  
  787.  
  788.      QUIT-    Choose this menu option to quit the VersaFAM program.
  789.  
  790.  
  791.      ESC key- Used to back up to a previous menu, or quit VersaFAM.
  792.  
  793.  
  794.  
  795.  
  796.      VersaFAM v1.14                    - 16 -
  797.  
  798.  
  799.      -------------------------------------------------------------------
  800.      THE OEC TEXT EDITOR
  801.      -------------------------------------------------------------------
  802.  
  803.      VersaFAM incorporates an OEC-capable text editor for editing of text and
  804.      file descriptions within a list file. If a line containing a valid
  805.      filename is chosen, only the file description can be modified.  If a
  806.      line containing a valid filename lacks a file description, a hyphen (-)
  807.      is placed in the first column of the file description as a "placeholder".
  808.      If a NON-FILE line is chosen, the entire line can be edited. The editor
  809.      is entered by selecting the WRITE option at the 2nd-level menu.
  810.  
  811.  
  812.      The following keystroke commands are available within the text editor:
  813.  
  814.  
  815.      ALT/I-      Toggles between insert and overstrike cursor mode.
  816.  
  817.  
  818.      ALT/E-      Deletes to the end of a line.
  819.  
  820.  
  821.      ALT/O-      Inserts an OEC color code into a line.  The resulting code
  822.                  value depends on the text and background color settings
  823.                  displayed in the lower left-hand corner of the screen during
  824.                  text edit mode.
  825.  
  826.  
  827.      ALT/B-      After an OEC code has been selected and placed using ALT-O,
  828.                  an additional code to create a "blinking" effect may be
  829.                  added by pressing ALT-B.  All characters after this code
  830.                  will blink, until another OEC code is encountered.
  831.  
  832.  
  833.      CTRL/<->    Moves cursor to beginning or end of a line.  CTRL -> will
  834.                  move the cursor to the last allowable character space on the
  835.                  current line (127th column for file and non-file entries).
  836.                  CTRL <-  will move the cursor to the beginning of the line.
  837.  
  838.  
  839.      CTRL/X-     Toggles <X-KEYS> mode when in REMOTE mode.  X-Keys allows
  840.                  selection of either cursor movement or number keys when 
  841.                  operating remotely.
  842.  
  843.      TAB and
  844.      SHIFT/TAB-  Tabs cursor forward and backward, respectively, on a line.
  845.  
  846.  
  847.      ALT/F1
  848.      thru
  849.      ALT/F10-    Allows selection of graphics character sets.
  850.  
  851.  
  852.      F1
  853.      thru
  854.      F10-        Allows output of graphics characters.
  855.  
  856.  
  857.  
  858.      VersaFAM v1.14                    - 17 -
  859.  
  860.  
  861.      CHANGING TEXT/BACKGROUND COLOR CODES
  862.      ------------------------------------
  863.      Background color and low/high-intensity text color can be changed by
  864.      pressing the following keys when in the text editor:
  865.  
  866.  
  867.            COLOR (lo/hi)      BACKGROUND(lo)  TEXT(lo)     TEXT(hi)
  868.            -----------------------------------------------------------
  869.            black/dk gray        ALT-1         SHIFT-F1      CTRL-F1
  870.            blue/lt blue         ALT-2         SHIFT-F2      CTRL-F2
  871.            green/lt green       ALT-3         SHIFT-F3      CTRL-F3
  872.            cyan/lt cyan         ALT-4         SHIFT-F4      CTRL-F4
  873.            red/lt red           ALT-5         SHIFT-F5      CTRL-F5
  874.            magenta/lt magenta   ALT-6         SHIFT-F6      CTRL-F6
  875.            brown/yellow         ALT-7         SHIFT-F7      CTRL-F7
  876.            lt gray/white        ALT-8         SHIFT-F8      CTRL-F8
  877.  
  878.  
  879.  
  880.  
  881.      HOW VERSAFAM INTERPRETS OEC CODES
  882.      ---------------------------------
  883.      Opus and other BBS software disallows the use of most ASCII characters
  884.      on the first column of a non-file line.  For example, if the letter 'A'
  885.      is typed in the first column of a file line, Opus will interpret this as
  886.      a filename, looking for a file named 'A'. Of course, this file will show
  887.      up as MISSING when listed in Opus.
  888.  
  889.  
  890.      VersaFAM v1.14                     - 18 -
  891.  
  892.  
  893.      APPROVED CHARACTERS
  894.      -------------------
  895.      To get around this restriction when creating non-file text lines, you
  896.      must use an "Opus-approved" character in the first text column.
  897.      Characters that Opus accepts in this position are listed below:
  898.  
  899.  
  900.                         Character   ASCII value
  901.  
  902.                           CTRL-A        1
  903.                           CTRL-B        2
  904.                           CTRL-C        3
  905.                           CTRL-D        4
  906.                           CTRL-E        5
  907.                           CTRL-F        6
  908.                           CTRL-G        7
  909.                           CTRL-H        8
  910.                           CTRL-I        9
  911.                           CTRL-J        10
  912.                           CTRL-K        11
  913.                           CTRL-L        12
  914.                           CTRL-M        13
  915.                           CTRL-N        15
  916.                           CTRL-O        16
  917.                           CTRL-V        22
  918.                           CTRL-Y        25
  919.                           space         32
  920.                             +           43
  921.                             ,           44
  922.                             -           45
  923.                             :           58
  924.                             <           60
  925.                             =           61
  926.                             >           62
  927.                             [           91
  928.                             \           92
  929.                             ]           93
  930.                             ^           94
  931.                             |           124
  932.                             ~           126
  933.  
  934.  
  935.      When a character is entered in the first column of a non-file text
  936.      line in text edit mode, VersaFAM will check to see if the character is
  937.      "approved".  If it is, it will be placed in the first text column.
  938.      If it is not an approved character, the text line will be padded at
  939.      the beginning by one character upon exiting the text editor.  The
  940.      value of the pad character is ASCII 32 (space) by default, but can be
  941.      defined as any other "approved" character by listing the desired
  942.      character after the TEXTFLAG verb in the VFAM.DAT configuration file.
  943.  
  944.  
  945.  
  946.      VersaFAM v1.14                    - 19 -
  947.  
  948.  
  949.      INTERPRETED VS. UNINTERPRETED OEC DISPLAYS
  950.      ------------------------------------------
  951.      VersaFAM implements a subset of the OEC (Opus Embedded Command) codes
  952.      used by Opus and other BBS software to control cursor movement, color
  953.      display and various other actions.  When the 2nd-level menu cursor is
  954.      moved over a text line, the actual, "uninterpreted" text line,
  955.      complete with OEC codes, will be displayed.  All other visible text
  956.      lines will display as "interpreted", showing the effects of any OEC
  957.      codes such as different colors, blinking, etc.
  958.  
  959.  
  960.  
  961.      VERSAFAM OEC LIMITATIONS
  962.      ------------------------
  963.      *ONLY* OEC commands having to do with the display of colors and
  964.      setting of the blink bit are recognized by VersaFAM.  All other OEC
  965.      codes will be displayed "uninterpreted".  Also unsupported are the
  966.      character compression commands (ASCII 25 codes) used in standard OEC.
  967.      A utility called OEC2VFAM has been included in this package to convert
  968.      standard OEC files to VersaFAM format by "expanding" any character
  969.      compression codes encountered, and writing the results to a new file.
  970.  
  971.  
  972.      Because the VersaFAM text editor is line-oriented, certain special
  973.      considerations must be given for OEC-coded text lines to display
  974.      properly.  OEC codes must be present on *each line* of a multiple-line
  975.      OEC display.
  976.  
  977.  
  978.  
  979.  
  980.      VersaFAM v1.14                    - 20 -
  981.  
  982.      -------------------------------------------------------------------
  983.      USING TEXT TEMPLATES
  984.      -------------------------------------------------------------------
  985.      VersaFAM incorporates a powerful text editing feature known as
  986.      "text templating".  Text templates are ASCII text files that can be
  987.      selectively inserted within list files, in order to relieve the tedium
  988.      often associated with editing such files.  "Boiler-plate" files for
  989.      descriptive headers, text boxes and other intricate designs can be
  990.      inserted with a keystroke, without having to laboriously re-create them
  991.      from scratch every time they are needed.
  992.  
  993.      Template files are inserted within a list file by pressing keys in the
  994.      range of CTRL-F1 through CTRL-F10, depending on which template is desired.
  995.  
  996.      Template files may be modified while in VersaFAM by PROBEing the template
  997.      filename into the main list file, positioning the cursor on the template
  998.      file name, then pressing ALT-L.  This displays the template file as an
  999.      "alternate" list file at the 2nd menu level.  The template file may now
  1000.      be edited like a normal list file by invoking the WRITE command.  When the
  1001.      2nd-level menu is exited, the regular list file name is reinstated.
  1002.      It is recommended that template files be assigned their own special
  1003.      subdirectory, and that this subdirectory be included in VersaFAM as an
  1004.      ACTIVE directory, to facilitate convenient editing of template files.
  1005.  
  1006.  
  1007.      VersaFAM v1.14                    - 21 -
  1008.  
  1009.  
  1010.      -------------------------------------------------------------------
  1011.      RUNNING VERSAFAM REMOTELY
  1012.      -------------------------------------------------------------------
  1013.      VersaFAM can be set up for remote operation by specifying "VFAM /R"
  1014.      in the batch file to be called.  The presence of the /R parameter
  1015.      signals VersaFAM to make all necessary adjustments for remote operation.
  1016.      The only thing the remote user has to remember to do is engage his/her
  1017.      NUM LOCK at the remote terminal.
  1018.  
  1019.      Menu selections in remote mode work the same as in local mode, with
  1020.      the exception of extended keycodes.  Extended keycodes are ALT, CTRL,
  1021.      SHIFT and function key combinations whose keycodes are not supported
  1022.      by most communications or terminal programs.  VersaFAM gets around this
  1023.      obstacle through creation of a "shorthand" mnemonic code used to invoke
  1024.      extended keycodes.  Examples of this code are illustrated below:
  1025.  
  1026.  
  1027.  
  1028.                Extended Keycode      VersaFAM "shorthand" code
  1029.                ----------------      -------------------------
  1030.                     ALT/F1                  A + F + 1  (3 keystrokes)
  1031.                     ALT/1                   A + 1
  1032.                     F6                      F + 6
  1033.                     ALT/C                   A + C
  1034.                     ALT/F10                 A + F + 0
  1035.                     CTRL/F1                 C + F + 1
  1036.                     SHIFT/F1                S + F + 1
  1037.  
  1038.  
  1039.  
  1040.  
  1041.      "Shorthand" code functionality is automatically available on 1st and 2nd
  1042.      level menus when running remotely.  A special "kludge" is needed for
  1043.      bringing this functionality to the Text Editor, however.  To distinguish
  1044.      the letter "A" from an ALT shorthand code for example, the <X-KEYS> mode
  1045.      has been created.  <X-KEYS> can only be invoked in remote mode, when the
  1046.      Text Editor is active.  When the CTRL-X keystroke combination (not an
  1047.      extended keycode) is pressed while in the Text Editor, <X-KEYS>
  1048.      will appear next to the <INDEX> legend.  Press CTRL-X again to toggle
  1049.      X-KEYS mode off.
  1050.  
  1051.  
  1052.      When not in X-KEYS mode, the following is true:
  1053.  
  1054.             A.  Pressing letter keys will output letters to the screen.
  1055.             B.  Pressing number keys will result in cursor movement.
  1056.             C.  Pressing cursor keys will result in cursor movement.
  1057.             D.  Entering "shorthand" codes will have no effect.
  1058.  
  1059.  
  1060.      When in X-KEYS mode:
  1061.  
  1062.             A.  Pressing letter keys (except letters A, C, F or S) will
  1063.                 output uppercase letters to the screen.
  1064.             B.  Pressing number keys will output numbers to the screen.
  1065.             C.  Pressing cursor keys will output numbers to the screen.
  1066.             D.  Entering "shorthand" codes will produce the desired effect.
  1067.  
  1068.  
  1069.      VersaFAM v1.14                  - 22 -
  1070.  
  1071.  
  1072.      -------------------------------------------------------------------
  1073.      VERSAFAM UTILITIES
  1074.      -------------------------------------------------------------------
  1075.      The VersaFAM distribution package includes several utility programs
  1076.      designed specifically for use with VersaFAM.
  1077.  
  1078.  
  1079.      FILEX FILE UPDATE UTILITY
  1080.      -------------------------
  1081.      FILEX.EXE provides a convenient method for adding new files and
  1082.      file descriptions to file areas when invoked as an external program.
  1083.      FILEX can also be run from the DOS prompt, or from within a batch file.
  1084.      Read FILEX.DOC for more information.
  1085.  
  1086.  
  1087.      CBFSORT FILE SORT UTILITY
  1088.      -------------------------
  1089.      CBFSORT.EXE is an exceptionally fast sort routine based on original code
  1090.      by Charles B. Falconer, a local professional programmer.  The CBFSORT
  1091.      program sorts individual groupings of valid file lines within a list file,
  1092.      without disturbing surrounding text or descriptive data.  CBFSORT is
  1093.      available as a "hard-coded" external program call, but can also be run
  1094.      from DOS or from within a batch file.
  1095.  
  1096.  
  1097.      OEC2VFAM CONVERSION UTILITY
  1098.      ---------------------------
  1099.      In recognition of the fact that most sysops will already have established
  1100.      file areas before using VersaFAM, the OEC2VFAM utility has been included to
  1101.      convert "standard" OEC-format files to VersaFAM format.  This conversion
  1102.      involves expansion of ASCII 25 compression codes used in standard OEC,
  1103.      replacing such codes with the actual characters they represent.  OEC2VFAM
  1104.      will scan a specified input file, then write the converted results to an
  1105.      output file, eliminating the need to manually re-format list files.
  1106.  
  1107.      VFADD PATH IMPORT UTILITY
  1108.      -------------------------
  1109.      The VFADD utility allows sysops of Opus<tm> BBSes to append VFAM.DAT
  1110.      with download path information taken from any existing SYSTEM??.BBS
  1111.      or SYSTEM??.DAT files located in the directory from which VFADD is
  1112.      called.  Before appending, path information can be sorted either
  1113.      according to SYSTEM?? file hierarchy (the default), or alphanumerically
  1114.      according to the path itself.
  1115.  
  1116.  
  1117.      VersaFAM v1.14                    - 23 -
  1118.  
  1119.      -------------------------------------------------------------------
  1120.      CREDITS AND COPYRIGHTS
  1121.      -------------------------------------------------------------------
  1122.         ARCA, ARCE      Copyright (C) System Enhancement Associates
  1123.         ARJ             Copyright (C) Robert K. Jung
  1124.         PAK             Copyright (C) NoGate Consulting
  1125.         LHARC, LHA      Copyright (C) Haruyasu Yoshizaki
  1126.         LIST            Copyright (C) Vernon D. Buerg
  1127.         PKZIP, PKUNZIP  Copyright (C) Phil Katz/PKWare
  1128.         DOORWAY         Copyright (C) Marshall Dudley
  1129.  
  1130.  
  1131.      -------------------------------------------------------------------
  1132.      THE VERSAFAM BETA TEST TEAM
  1133.      -------------------------------------------------------------------
  1134.      My heartfelt thanks to the following people for debugging my
  1135.      (sometimes imperfect) dream and making VersaFAM a reality:
  1136.  
  1137.      Don Dawson, Bowen Goletz, Karl Hoedl, Moe Lanza, Rick Moore,
  1138.      Dale Pausinga, Furlan Primus, Chris Regan, Jose Avelar, Rick Ashworth
  1139.      and any other testers whose names I may have forgotten in the heat of 
  1140.      the moment....
  1141.  
  1142.      -------------------------------------------------------------------
  1143.      HOW TO CONTACT THE AUTHOR
  1144.      -------------------------------------------------------------------
  1145.      Please send all VersaFAM comments, criticisms and bug reports to:
  1146.  
  1147.                             Bill Auclair
  1148.                             Xanadu BBS, Naugatuck CT USA
  1149.                             FidoNet 1:141/545.0
  1150.  
  1151.      -------------------------------------------------------------------
  1152.      REGISTRATION
  1153.      -------------------------------------------------------------------
  1154.      Registering the VersaFAM package ($15.00) will entitle you to:
  1155.  
  1156.            a)  A customized VersaFAM executable file.
  1157.            b)  Free program updates via FidoNet or U.S. Snail.
  1158.            c)  My heartfelt thanks.
  1159.  
  1160.      More details on registration are available in the REGISTER.DOC file.
  1161.      NOTE:  This unregistered version of VersaFAM is NOT CRIPPLED IN ANY WAY.
  1162.  
  1163.      -------------------------------------------------------------------
  1164.      MORE ABOUT TURBOPOWER SOFTWARE
  1165.      -------------------------------------------------------------------
  1166.      If you'd like to know more about TurboPower Software and their
  1167.      many fine public domain and shareware programs, write to Kim
  1168.      Kokkonen at the following address:
  1169.  
  1170.                             Kim Kokkonen, President
  1171.                             TurboPower Software
  1172.                             P.O. Box 66747
  1173.                             Scotts Valley, CA  95066
  1174.  
  1175.  
  1176.